package com.guojiang.guopicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.guojiang.guopicturebackend.model.dto.space.SpaceAddRequest;
import com.guojiang.guopicturebackend.model.dto.space.SpaceQueryRequest;
import com.guojiang.guopicturebackend.model.entity.Space;
import com.baomidou.mybatisplus.extension.service.IService;
import com.guojiang.guopicturebackend.model.entity.User;
import com.guojiang.guopicturebackend.model.vo.space.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
 * @author 过江辉
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-01-20 02:16:26
 */
public interface SpaceService extends IService<Space> {

    /**
     * 校验空间合法性
     *
     * @param space
     */
    void validSpace(Space space);

    /**
     * 获取空间封装类
     *
     * @param space
     * @param request
     * @return
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 分页空间封装类列表
     *
     * @param spacePage
     * @param request
     * @return 空间封装类分页列表
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 获取空间查询对象
     *
     * @param spaceQueryRequest
     * @return
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);

    /**
     * 根据空间级别填充空间对应字段
     *
     * @param space
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 创建空间（一个用户只能创建一个空间）
     *
     * @param spaceAddRequest
     * @param user
     * @return
     */
    long addSpace(SpaceAddRequest spaceAddRequest, User user);

    /**
     * 校验空间权限
     *
     * @param space
     * @param loginUser
     */
    void checkSpaceAuth(Space space, User loginUser);
}
